Beispiel: Bibliothek mit Bausteinen inkl. Hilfe-Dateien erstellen
Falls Sie eine eigene Bibliothek mit Bausteinen erstellen, wollen Sie möglicherweise auch eine externe HTML-Bausteinhilfe in die Bibliothek inkludieren. Falls sich der Anwender über den Baustein aus der Bibliothek informieren will, kann der Anwender somit die lokale HTML-Hilfe für den Baustein öffnen, um sich über den Baustein zu informieren. Bedingungen für das erfolgreiche Öffnen der Bausteinhilfe sind:
-
die Definition der Dateien für die externe Bausteinhilfen in der Bibliothekskonfiguration – mit Hilfe der Anweisung
FILE := ...
-
die korrekte Ablage dieser Hilfedateien in der Bibliothek – Diese korrekte Ablage wird durch das Schlüsselwort
SOURCEPATH
in der Bibliothekskonfiguration erreicht Siehe "Deklaration des Inhalts für die Bibliothek", falls Sie Informationen zu diesem Schlüsselwort benötigen.
Das folgende Beispiel einer Bibliothekskonfiguration illustriert die erforderliche Ablage der Dateien für die externe Bausteinhilfe.
Beispiel einer Bibliothekskonfiguration mit externer Bausteinhilfe | |
---|---|
Das folgende Beispiel bewirkt, dass die erzeugte Bibliothek:
|
Details, warum die Dateien für die externe Bausteinhilfe so angegeben werden:
-
Jede Anweisung
FILE := ...
, die im obigen Beispiel einer der AnweisungenIEC := ...
nachfolgt, nennt eine Datei für die externe Bausteinhilfe. Dies sind jene HTML-Dateien, PNG-Dateien und CSS-Dateien, die beim Erzeugen der externe Bausteinhilfe entstanden sind. -
Diese Dateien wurden im Projekt in einem Ordner
.olh
erzeugt, der parallel zum Objekt mit dem Baustein liegt und standardmäßig nicht im Projektexplorer sichtbar ist.
Beispiel: Liegt das Objekt mit dem Baustein im Ordnersrc
des Projekts, wurden die Dateien im Ordnersrc\.olh
des Projekts erzeugt. Wenn die Bibliothek erzeugt wird, sollen also die Dateien aus diesem Ordnersrc\.olh
verwendet werden. -
Die Dateien für die externe Bausteinhilfe dürfen in der erzeugten Bibliothek aber nicht im Ordner
Motors\src\.olh
abgelegt werden, sondern im OrdnerMotors\.olh\
– Daher wird das SchlüsselwortSOURCEPATH
mit dem zusätzlichen Pfadsrc
verwendet. Nun wird die jeweilige Datei zwar im Ordnersrc\.olh
des aktuellen Projekts gesucht, aber im Ordner.olh
parallel zum Objekt mit dem Baustein in der Bibliothek abgelegt.
Gut zu wissen |
---|
Wenn Sie die Anweisung |